Prettify Cycamore docs #626
Conversation
Build Status Report - 390f3bc - 2024-09-21 10:02:24 -0400Build
|
doc/doxygen-awesome.css
Outdated
There was a problem hiding this comment.
Can we get this from cyclus rather than including it again?
There was a problem hiding this comment.
We could modify the cyclus build to install the stylesheet somewhere in ${INSTALL_DIR}/share/cyclus (perhaps we add a doc/ subdirectory). I'm not sure how else to get it from cyclus, what do you think?
There was a problem hiding this comment.
Does it make sense to do the same with the logo?
|
I'm happy to merge this now and wait for style sheet cross-repo fixes... |
|
Something odd is happening... the new style changes (for cyclus) are present in the artifact generated by cyclus.github.com actions but I'm not seeing them in the published site. The docs were present before adding them back into the build so I'm wondering if there's another server somewhere? |
|
Aha! The cyclus repo has Pages set up to serve the docs. Is it okay if I turn this (and the cycamore one) off? That way the docs will be accessible from just the cyclus.github.com site |
|
Just to make sure I understand... it seems that And that is blocking the ability to simply serve docs from the website file structure.... I think it's probably OK to turn of pages since the same URL will serve the new information and we never had a mechanism to automate the update of the The other alternative would be something that guarantees that the |
Yes, this is my understanding.
That is also an option. It would require that we maintain actions in cylus and cycamore to do this. I think I would lean toward managing all of the site content in one place (cyclus.github.com's Dockerfile) for the sake of transparency. Having subpaths of a website served from separate repositories doesn't feel very intuitive, and is part of the reason it took me so long to understand where those docs were being produced. |
|
Also I went ahead and changed this to find the stylesheet/gif at the location installed by cyclus. |
Makes essentially the same changes as cyclus/cyclus#1787
zip for preview
html.zip